Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d18 / tsnap101.arc / TSNAP.DOC < prev next >

Wrap

Text File | 1991-04-28 | 16KB | 404 lines

Version 1.01 September 24, 1989 TSNAP ----- Copyright (c) 1989, Future Vision Inc TSNAP was written by Steve Simpson of Future Vision Inc. Steve is an independent software engineering consultant with over fifteen years of software experience. TSNAP is a shareware program. Please support this program by sending $10 for product registration to: Future Vision Inc P.O. Box 34 N Billerica, MA 01862 Tel: (508) 663-8591 What is TSNAP? -------------- TSNAP is a TSR utility that automatically converts editing commands used in the "Brief" editor into the editing commands used in both Turbo C and Turbo Pascal. TSNAP will make your editing in the Turbo Environment easier, faster, and much more productive. The Brief Programmer's Editor is published by: Solution Systems, 541 Main St, Suite 410, S Weymouth, MA 02190. Tel: (800) 821-2492. Brief was written by: UnderWare Inc, 321 Columbus Ave, Boston, MA 02116. Tel: (800) 343-7308. Future Vision Inc has no connection with Solution Systems or UnderWare Inc. Please do not contact either of the above two firms with questions about TSNAP. The TSNAP TSR is completely independent of the Brief editor. Brief is NOT required to run the TSNAP TSR. Trademarks ---------- Turbo C and Turbo Pascal are trademarks of Borland International. Brief is a trademark of UnderWare, Inc. UnderWare is a trademark of UnderWare, Inc. Solution Systems is a trademark of the Software Developer's Corporation. ---------------------------------------------------------------------- This product uses the TesSeRact(TM) Ram-Resident Library and supports the TesSeRact Standard for Ram-Resident Program Communication. For information about TesSeRact, contact the TesSeRact Development Team at: TesSeRact Development Team 1657 The Fairways Suite 101 Jenkintown, PA 19046 Phone: 215-884-3373 CompuServe: 70731,20 MCIMAIL: 315-5415 FAX: 215-886-4225 This MCIMAIL Account has been provided to the TesSeRact Development Team by Borland International, Inc. The TesSeRact Development Team is in no way associated with Borland International, Inc. TesSeRact is a trademark of the TesSeRact Development Team. ---------------------------------------------------------------------- Installing TSNAP on your system disk ------------------------------------ Copy the TSNAP executable tsnap.exe to a convenient directory on your hard disk. A good directory to put it in would be one of the "set path" directories. Type "path" on the command line prompt to see the search path the system is using to find executable programs. Installing the TSNAP TSR in memory ---------------------------------- Type "tsnap" on the command line to install TSNAP in memory. If tsnap.exe was copied to one of your "set path" directories, the operating system will automatically find tsnap.exe on your disk. Removing the TSNAP TSR from memory ---------------------------------- Type "tsnap -r" on the command line to remove TSNAP from memory. TSNAP cannot remove itself from memory if it detects that you have installed another TSR after TSNAP was installed. If this is the case, TSNAP will suspend itself and wait until the later TSR is first removed from memory before removing itself. If the TSNAP TSR is suspended, typing "tsnap" will reactivate the suspended copy of the TSR rather than causing a second copy of TSNAP to be loaded into memory. Automatic detection of Turbo C and Turbo Pascal ----------------------------------------------- Once TSNAP is installed in memory, it lies dormant waiting and watching until you execute either Turbo C or Turbo Pascal. When it detects that you are running either of these programs, it starts looking for Brief editor commands and converts them to the Turbo editor commands. When you exit Turbo C or Turbo Pascal (with Control-X), TSNAP returns to its dormant state. TSNAP's command line switches ------------------------------ "tsnap " Install tsnap TSR into memory. "tsnap -r " Removes a previously installed copy from memory. "tsnap -dpath" Change temp directory path (40 chars). Default = c:\temp "tsnap -fname" Change temp cutpaste filename (12 chars). Default = cutpaste.dat "tsnap -? " Command line help. Notes for non-Brief users. What will TSNAP do for me? ------------------------------------------------------ One of the nicest features of TSNAP is its quick and easy cut and paste facility. With TSNAP, it's a snap to move or copy a chunk of code from one place in a file to another. With the Alt-N command (Next file), it's just as easy to move or copy from one file to different file as it is move or copy within the same file. Many simple functions are unbearably messy in the Turbo environment. For example, to duplicate a line it is necessary to type "HOME ^K ^B DOWN ^K ^K ^K ^C ^K ^H". With TSNAP duplicating a line is accomplished by simply typing "+ INS". Brief editing commands supported by TSNAP ----------------------------------------- Alt-A Begin marked area. Pressing Alt-A again aborts marking. In others words if you begin a marked area with Alt-A and you change your mind, simply press Alt-A again. - Cut a line into the save buffer OR cut the marked area into the save buffer. (Note: '-' is the keypad '-'.) + Save a line in the save buffer OR save the marked area in the save buffer. (Note: '+' is the keypad '+'.) INS Pastes the save buffer into the file. DEL Delete a character OR delete the marked area. HOME Home pressed once : moves cursor to the beginning of the line. Home pressed twice (in a row) : moves cursor to the beginning of the page. Home pressed three times (in a row) : moves cursor to beginning of the file. END End pressed once : moves cursor to the end of the line. End pressed twice (in a row) : moves cursor to end of the page. End pressed three times (in a row) : moves cursor to end of the file. F5 Search forward. Alt-F5 Search backward. Shift-F5 Search again (in the same direction). F6 Replace forward. Alt-F6 Replace backward. Shift-F6 Replace again (in the same direction). Ctrl-F5 Reverse search/replace case sensitivity (default = ON). Global Replace -------------- Note: Replace has a new global replace feature. In addition to answering Y or N during a replace operation, you can now answer G for a global replace (automatically answer Y). The G has effect from the current position to the end of the file (or to the beginning of the file if you are replacing backwards). When a global replace is completed, the cursor is returned to the file position where the replace first began. It is important to note that with TSNAP's replace you can perform a global replace from any point in the file to either the beginning or the end of the file. With Turbo you have no choice, a global replace will perform the replace on the entire file regardless of your initial file position. Turbo's "Replace (Y/N):" on the status line is changed to "Replace (YGN):" to show that you can also press perform a global replace. Alt-D Delete a line. Alt-I Reverse Insert/Overstrike mode. Alt-K Delete to the end of the line. Alt-W Write the file to disk. Alt-N Next file. You can scan through each of the edit files (if you are editing more than one) by continuing to press Alt-N. IMPORTANT FEATURE: With TSNAP it is QUICK and EASY to cut or save a line or an area of your program code from one file, press Alt-N, and paste it into another file. Ctrl-U Scroll text in window up. Ctrl-D Scroll text in window down. Examples: ("..." in the examples represent cursor movement commands) -------- - Cuts the current line. The saved line may be inserted elsewhere by pressing INS. + Saves the current line. The saved line may be inserted elsewhere by pressing INS. Alt-A ... - Cut an area into the save buffer. Alt-A ... + Save an area into the save buffer. - ... INS Moves a line. (Line cut followed by paste). + ... INS Copies a line. (Line save followed by paste). Alt-A ... - ... INS Moves an area. (Marked area cut followed by paste). Alt-A ... + ... INS Copies an area. (Marked area save followed by paste). Alt-A ... - Alt-N ... INS Moves an area from one file to another. (Marked area cut in one file followed by paste in another file). Alt-A ... + Alt-N ... INS Copies an area from one file to another. (Marked area save in one file followed by paste in another file). Notes for Brief users. Differences between TSNAP and Brief ----------------------------------------------------------- Marking a block and pressing DEL does a cut of the marked area INTO THE SAVE BUFFER. (Brief deletes the marked area without touching the save buffer). We changed the way this works because there presently is no UNDO capability. It was simply too easy to accidently press DEL instead of + with the result that instead of saving the block you would have PERMANENTLY lost it. Note: Alt-D does works the same as in Brief: it deletes the line without touching the save buffer. Turbo's F5, F6, Alt-F5, Alt-F6 keys ----------------------------------- Both TSNAP and Turbo's editor use the F5, F6, Alt-F5, Alt-F6, keys. In TSNAP, the keys mean: search forward, search backward, replace forward, and replace backward. In Turbo, the keys mean: zoom, switch, user screen, and swap. To execute the Turbo meaning of the keys, simply press the key twice (in a row). For example, pressing F5 starts a string search, pressing F5 F5 performs the Turbo zoom function. Future enhancements ------------------- We hope to add a limited UNDO capability, bookmarks, "Alt -" (the reverse of Alt N), and keyboard macros. We would like hear your ideas and suggestions on how to improve TSNAP. Please contact us at the address listed at the top of this document. Temporary files --------------- TSNAP uses the temporary file c:\temp\cutpaste.dat as a cutpaste buffer. The default directory (c:\temp) can be changed with the -dname switch on the command line. The default cutpaste buffer filename (cutpaste.dat) can be changed with the -fname switch on the command line. Example: "tsnap -dc:\tc\temp" will change the default TSNAP directory. When TSNAP is first installed in memory, it creates the temporary directory and file if it does not already exist. The temporary file must already exist before performing any cutting or pasting during your editing. If your change the default temporary directory with the -d command line switch, the disk name should always be specified as part of the directory path. TSNAP's Temporary Use of Placement Markers ------------------------------------------ The Turbo Pascal and Turbo C editors have four place markers (0 through 3). TSNAP uses markers 2 and 3 whenever you press Alt-A and mark backwards through the text. Place marker 3 is used whenever you perform a replace operation. Place markers 0 and 1 are presently not used by TSNAP. TSNAP Version History --------------------- 1.01 9/24/89 Added on/off choices to popup menu. The automatic detection of Turbo Pascal/C only works for DOS version 3 and up. The on/off menu choices allow TSNAP to be used with DOS 2 users. 1.00 9/20/89 Initial release. Quick Reference --------------- - Cut a line or marked area. + Save a line or marked area. Alt-A Start marking an area. Alt-A aborts. Alt-A ... - Cut an area. Alt-A ... + Save an area. INS Paste. DEL Delete char or marked area. HOME Goto beginning of the line. HOME HOME Goto beginning of the page. HOME HOME HOME Goto beginning of the file. END Goto end of the line. END END Goto end of the page. END END END Goto end of the file. F5 Search forward. Alt-F5 Search backward. Shift-F5 Search again (in the same direction). F6 Replace forward. Alt-F6 Replace backward. Shift-F6 Replace again (in the same direction). Ctrl-F5 Reverse case sensitivity (default = ON). F5 F5 Turbo's zoom command. ALT-F5 ALT-F5 Turbo's switch command. F6 F6 Turbo's user screen command. ALT-F6 ALT-F6 Turbo's swap command. Alt-D Delete a line. Alt-K Delete (Kill) to the end of the line. Alt-I Reverse Insert/Overstrike mode. Alt-W Write file. Alt-N Next file. Ctrl-U Scroll text in window up. Ctrl-D Scroll text in window down.